home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / ifl / TIFFReadScanline.z / TIFFReadScanline
Encoding:
Text File  |  1998-10-20  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddSSSSccccaaaannnnlllliiiinnnneeee((((3333TTTT))))                 IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFReadScanline - read and decode a scanline of data from an open TIFF
  10.      file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  14.      iiiinnnntttt TTTTIIIIFFFFFFFFRRRReeeeaaaaddddSSSSccccaaaannnnlllliiiinnnneeee((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, ttttddddaaaattttaaaa____tttt bbbbuuuuffff,,,, uuuuiiiinnnntttt33332222 rrrroooowwww,,,, ttttssssaaaammmmpppplllleeee____tttt
  15.      ssssaaaammmmpppplllleeee))))
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      Read the data for the specified row into the (user supplied) data buffer
  19.      _b_u_f.  The data are returned decompressed and, in the native byte- and
  20.      bit-ordering, but are otherwise packed (see further below).  The buffer
  21.      must be large enough to hold an entire scanline of data.  Applications
  22.      should call the routine _T_I_F_F_S_c_a_n_l_i_n_e_S_i_z_e to find out the size (in bytes)
  23.      of a scanline buffer.  The _r_o_w parameter is always used by
  24.      _T_I_F_F_R_e_a_d_S_c_a_n_l_i_n_e; the _s_a_m_p_l_e parameter is used only if data are organized
  25.      in separate planes (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).
  26.  
  27. NNNNOOOOTTTTEEEESSSS
  28.      The library attempts to hide bit- and byte-ordering differences between
  29.      the image and the native machine by converting data to the native machine
  30.      order.  Bit reversal is done if the _F_i_l_l_O_r_d_e_r tag is opposite to the
  31.      native machine bit order.  16- and 32-bit samples are automatically
  32.      byte-swapped if the file was written with a byte order opposite to the
  33.      native machine byte order,
  34.  
  35.      In C++ the _s_a_m_p_l_e parameter defaults to 0.
  36.  
  37. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  38.      _T_I_F_F_R_e_a_d_S_c_a_n_l_i_n_e returns -1 if it detects an error; otherwise 1 is
  39.      returned.
  40.  
  41. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  42.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  43.  
  44.      CCCCoooommmmpppprrrreeeessssssssiiiioooonnnn aaaallllggggoooorrrriiiitttthhhhmmmm ddddooooeeeessss nnnnooootttt ssssuuuuppppppppoooorrrrtttt rrrraaaannnnddddoooommmm aaaacccccccceeeessssssss.  Data was requested
  45.      in a non-sequential order from a file that uses a compression algorithm
  46.      and that has _R_o_w_s_P_e_r_S_t_r_i_p greater than one.  That is, data in the image
  47.      is stored in a compressed form, and with multiple rows packed into a
  48.      strip.  In this case, the library does not support random access to the
  49.      data.  The data should either be accessed sequentially, or the file
  50.      should be converted so that each strip is made up of one row of data.
  51.  
  52. BBBBUUUUGGGGSSSS
  53.      Reading subsampled YCbCR data does not work correctly because, for
  54.      _P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2 the size of a scanline is not calculated on a per-
  55.      sample basis, and for _P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=1 the library does not unpack
  56.      the block-interleaved samples; use the strip- and tile-based interfaces
  57.      to read these formats.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIFFFFFFFFRRRReeeeaaaaddddSSSSccccaaaannnnlllliiiinnnneeee((((3333TTTT))))                 IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_R_e_a_d_E_n_c_o_d_e_d_S_t_r_i_p(3T), _T_I_F_F_R_e_a_d_R_a_w_S_t_r_i_p(3T)
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.